home *** CD-ROM | disk | FTP | other *** search
/ Cobra Utilities for Doom & Doom II / Cobra Utilities For Doom & Doom II - Disc 2.iso / files / program / wm150 / wm.doc < prev    next >
Encoding:
Text File  |  1994-06-23  |  11.4 KB  |  252 lines
  1. WadManager v1.50
  2. ----------------
  3.  
  4. Disclaimer
  5. ----------
  6. I hold no responsibility for any loss or damage caused by the use of WadManager
  7. I have tested this version thoroughly and it shouldn't cause any problems. Of
  8. course I know the program and know what it's supposed to do, and what it isn't,
  9. but I have tried to make it crashproof and hopefully foolproof. Use and enjoy!
  10.  
  11. Introduction
  12. ------------
  13. Hello DOOMers, here is a small utility I have created that allows you to
  14. easily choose and load all those extra levels that have been uploaded to the
  15. DOOM sites. WadManager works with DOOM 1.2 only.
  16. The WadManager distribution is composed of 4 (four) files :
  17.  
  18.     WM.COM - The executable - run this by typing WM at the prompt
  19.     WM.EXE - The main program - do not run this
  20.     WM.INI - Configuration file
  21.     WM.DOC - This file
  22.  
  23. Requirements
  24. ------------
  25.     DOOM 1.2 - If you don't have this...
  26.     a mouse  - Sorry, no keyboard support yet ( if ever )
  27.     a VGA    - Well, if you have DOOM...
  28.  
  29. How to setup WadManager
  30. -----------------------
  31. Edit the WM.INI file to reflect your configuration.
  32. The available settings are :
  33.  
  34.   DOOMDIR - Where DOOM is, obviously
  35.   WADDIR - Where your WADs are stored
  36.   IPXDRIVER - The name (no path) of the IPX driver (default IPXSETUP.EXE)
  37.   SERDRIVER - The name (no path) of the serial driver (default SERSETUP.EXE)
  38.   IPXSOCKET - The network socket you usually use (default 0)
  39.   MODEMNUMBER - The number of your favourite DOOM modem user
  40.   AUTORET - YES/NO if you want WadManager to put a return keypress in the
  41.     keyboard buffer automatically in network/modem/serial modes. If your
  42.     serial/network driver expects input before running DOOM then put NO 
  43.     here, otherwise put YES (default YES)
  44.     If used in combination with the MODEMCFG option, then WM will put the
  45.     relevant keys in the buffer so you don't have to do it yourself. 
  46.     Warning : this last part hasn't been fully tested, so if SER4 doesn't 
  47.     work report it to me and I'll fix it. 
  48.   AUTOLOAD - A semicolon separated list of the WADs you want WM to 
  49.     automatically select on startup. Useful for WADs with graphics and 
  50.     music. (default none).
  51.   MODEMCFG - YES/NO if you are using SER4 this will modify the MODEM.CFG so 
  52.     that parameters can be passed to DOOM. WM expects MODEM.CFG to be in the
  53.     DOOMDIR. (default NO) WARNING : This has not been fully tested.
  54.     If you use this feature, leave the lines for episode, savegame,
  55.     no monsters, respawn and devparm blank. 
  56.   COM - 1,2,3 or 4. The COM port you want to use in serial/modem modes.
  57.     (default 1).
  58.  
  59. Only WADDIR and DOOMDIR are compulsory, all the others have the standard
  60. default values.
  61.  
  62. Now you're ready to run WadManager.
  63.  
  64. Using WadManager
  65. ----------------
  66. Just type WM at your DOS prompt and WadManager's main screen will appear
  67. showing all the available WADs in three columns. If the WADs don't fit on the
  68. screen two arrows will appear at the bottom of the screen so you can scroll
  69. up and down. Clicking with the left button on these arrows will scroll one
  70. line at a time, while clicking with the right button will scroll a whole page
  71. at a time.
  72.     The first WAD on the screen will always be the original DOOM.WAD.
  73. If you have put any WAD names in the AUTOLOAD setting they will already be
  74. selected. You can select a WAD by left-clicking on it. Doing this will remove
  75. all previous selections. If, instead, you want to select a WAD without
  76. deselecting all the others, right-click on it. Selected WADs have a number
  77. on the left indicating the order in which they will be loaded. You can
  78. deselect a previously selected WAD by right-clicking on it again. 
  79.     The maximum number of WADs you can select is 9, and if this seems to you 
  80. like an annoying limitation, bear in mind that the DOS command line can't be 
  81. longer than 127 characters, and if you select lots of WADs and extra options, 
  82. you can understand that it can grow to enormous sizes. Blame Microsoft ( as 
  83. usual ). If only iD allowed the use of a response file... maybe 1.4 will. 
  84. Anyway WM will tell you if the command line is too long. I have chosen to 
  85. allow a maximum of nine WADs to be loaded because that is the number of 
  86. missions in an episode.
  87.  
  88. After you have selected the WAD or WADs you want to load just click on OK
  89. and a dialog box will appear letting you choose from Standard, Network, Modem
  90. and Serial games, what level to start from and what difficulty skill. You
  91. can also choose No Monsters and Respawn. If you have selected multiple WADs,
  92. WM will check that these WADs don't change the same levels. If this happens
  93. you will be presented with the option of returning to the WAD selection screen
  94. or continue. Be aware of the fact that DOOM will use the resources in the last
  95. loaded file first, working its way backwards.
  96.  
  97. Click on the DOOM button to start DOOM or the CANCEL button to return to the
  98. list of WADs.
  99.  
  100. If you have chosen Serial, Modem or Network game, instead of starting DOOM, a
  101. second window will appear allowing you to change the settings for that
  102. particular mode. You can choose Cooperative or Deathmatch modes, starting from
  103. a particular saved game, what IPX socket to use or what phone number to call.
  104.  
  105. After you have finished playing, quit DOOM and you'll return to WadManager
  106. where you can choose other WADs or exit by clicking on the QUIT button.
  107.  
  108. Other Functions
  109. ---------------
  110. The DELETE button will delete all selected WADs from your hard disk. If your
  111. selection contains DOOM.WAD, then you won't be able to delete the other WADs.
  112. Just deselect DOOM.WAD and press the DELETE button again. WM asks you to
  113. confirm your choice, but it DOESN'T ask for confirmation for every file.
  114. If you delete a WAD by mistake, quit immediately and undelete it, before any
  115. other program overwrites the disk space.
  116.  
  117. The ABOUT button is self explanatory.
  118.  
  119. The INFO button gives more information about the tagged WADs : what levels
  120. they contain, if they have new sounds, music, graphics or demos. If you click
  121. on a WAD, another window will pop up allowing you to change the missions in 
  122. it. To do so just drag and drop the ticks from their original position to the 
  123. new one. By clicking on the SAVE button, WadManager will change the PWAD to 
  124. reflect your edits. This feature is useful if you want to play with multiple 
  125. WADs, but some of them have clashing levels, or have missions in different 
  126. episodes, or you prefer another mission's music. Beware that SAVE doesn't ask 
  127. for confirmation. Notice : a WAD that changes the instruments mapping 
  128. information has a tick in the music column even if it doesn't contain any
  129. music. This is for GUS1M.WAD and similar PWADs.
  130. In the Info window, if you click on the WAD's name a text window will appear
  131. displaying the TXT file associated with the selected WAD. Tabs and multiple
  132. spaces are converted to single spaces and lowercase is converted to uppercase
  133. because of the screen width limitation (320 pixels). Sorry if the font is not
  134. very readable, but it's the best I could come up with in a 4-pixel width.
  135. WM will now read UNIX-style text files without any problem, apart from MSDOS-
  136. style ones. 
  137.  
  138. WARNING : DO NOT run WM.EXE !!! Always run WM.COM. WM.EXE will not run anyway.
  139.   If you just type WM, MSDOS will automatically run the COM.
  140.  
  141. About WadManager
  142. ----------------
  143. WadManager is written in Borland Pascal 7.0 and Turbo Assembler 3.2 using my 
  144. XLibPas v2.0 library.
  145. WadManager is completely free and you may distribute it as much as you like.
  146. Some users have actually suggested that I distribute this as shareware, but
  147. I don't agree with this for a number of reasons :
  148.   1) I don't believe this small effort of mine is worth much.
  149.   2) I can't ensure that I will always continue support and development for
  150.      WadManager because of other projects I have. Don't worry though, I'm a
  151.      perfectionist and, while people are still sending me suggestions to 
  152.      improve WM, I will update it.
  153.   3) I don't think people should be hassled by messages all over the place
  154.      about the fact that if they have been using a certain program for more
  155.      than a certain number of days, then they are breaking the law and should
  156.      register as soon as possible : they don't anyway (apart from DOOM I 
  157.      hope :-).
  158. One important thing though : if you like using this program please send me a 
  159. postcard of your hometown at the following address :
  160.  
  161.         Tristan Tarrant
  162.         Via Lucinasco 15
  163.         22070 Montano Lucino (CO)
  164.         ITALY  (Yes, Italy !!!)
  165.  
  166. If you have any problems/comments/suggestions email me at the following :
  167.  
  168.         tristant@cogs.susx.ac.uk
  169.  
  170. You can get the latest version of WadManager from :
  171.  
  172.     infant2.sphs.indiana.edu /pub/doom/misc
  173.  
  174. though I suggest checking the incoming directory first for any recent uploads.
  175. And if I can get on to wuarchive.wustl.edu, it will also be in the MsDos
  176. uploads DOOM directory somehwere.
  177.  
  178. I might also be persuaded in sending you the latest version of WadManager in
  179. uuencoded format.
  180.  
  181. Some things I might add in the future :
  182.  
  183.     Renaming the WADs.
  184.     Ability to have different WAD directories
  185.     Ability to select soundcard settings
  186.     Ability to edit the multiplayer macros
  187.     No need to be smaller than SETUP.EXE, it can be as big as I want 
  188.       to :-)
  189.  
  190. Thanks to the guys at iD Software for creating such a great product as
  191. DOOM...
  192.  
  193. This is also the last version I will be releasing for a while : it's time for
  194. a holiday now. See you in September, when hopefully DOOM II : Hell on Earth 
  195. will be out (if it isn't out in two weeks ;-)
  196.  
  197. P.S.
  198. If my Software Engineering tutor had a look at my code, he would definitely 
  199. say that it's the worst example of bad cohesion he's ever seen...
  200.  
  201. Versions
  202. --------
  203. v1.0 - Initial release.
  204.  
  205. v1.01 - WAD sorting added.
  206.  
  207. v1.05 - WAD scanning added : now WadManager knows what missions are available
  208.       in the selected WAD and displays them in a different colour.
  209.       Added WAD deletion. 1st release.
  210.  
  211. v1.06 - Maximum number of WADs now 512 (was 128). Added possibility to choose
  212.       No Monsters and Respawn.
  213.  
  214. v1.07 - Added Autoload feature.
  215.  
  216. v1.08 - Added multiple WAD selection and deletion. Fixed a little bug in the
  217.       selection mechanism.
  218.  
  219. v1.09 - Fixed nasty bug when deleting files that were in the AUTOLOAD. Also
  220.       fixed fact that in certain occasions it wasn't possible to view
  221.       all WADs.
  222.  
  223. v1.10 - Added Info button.
  224.  
  225. v1.11 - Added ability to change mission numbers. 2nd release.
  226.  
  227. v1.11a to v1.11c - Various minor bugfixes.
  228.  
  229. v1.11d - Now WadManager automatically selects the first available mission.
  230.        Now it's possible to select in the INFO box only those WADs that
  231.        have extra missions.
  232.  
  233. v1.11e - There was one...but I can't remember what it fixed.
  234.  
  235. v1.12 - Added page scrolling with right button.
  236.  
  237. v1.13 - Added support for SER4 and bugfixes in WM.INI code.
  238.  
  239. v1.14 - Added TXT reading. 3rd release.
  240.  
  241. v1.14a - Fixed SER4 code where COM2 became COM1, COM3 became COM2 and so on.
  242.     Also added COM directive in WM.INI
  243.  
  244. v1.50 - Added swapping : now WM only takes 1336 bytes in memory when running
  245.     DOOM. If I hear someone complaining about WM taking up too much 
  246.     memory... Also DELETE now deletes the TXT files, if they exist. 
  247.     Added QUIT button to the TXT reading display. Fixed CR/LF problem in
  248.     text files : now WM reads and displays properly any text file.
  249.     Question mark in the font used for TXT reading was screwed. Various
  250.     bugfixes. Added WAD count at the bottom of the screen and in INFO box.
  251.     4th release.
  252.